The Instances Page

Use the Instances page to manage your result set instances. In addition to creating and deleting result set instances, use this page to reload the data in your result sets, and retrieve your instances' OData feed URLs.

Create a Result Set Instance

To create a result set instance, follow these steps:

  1. Select the result set definition you wish to create an instance of (instantiate) using the Definition drop-down menu.
  2. Click the Create button.
  3. Set up your instance's options:
  4. Click image to expand or minimize.

    1. Enter a name for your instance in the Instance Name field.
    2. Select the version of your data that will be added to your result set instance using the Version drop-down menu.
    3. (Optional) Enter a description of your instance in the Comment field.
  5. When you’ve finished setting up your instance, click the Save button.
  6. Your new instance will be listed in the Result Set Instances table.
  7. Each time you create a result set instance, its loader will run automatically to populate it with data. During this time, the instance's state will be listed as initializing. You can monitor the loader's progress using The Job Results Page.

    Click image to expand or minimize.

  8. After the instance has been populated with data, its state will change to Valid.

Reload the Data in a Result Set Instance

To reload the data in a result set instance, click the Reload () icon in its row, or select its row and then click the Reload button near the top of the screen.

Click image to expand or minimize. 

The instance's state will change, and the loader assigned to the instance's definition will run. You can monitor the progress of the loader on the The Job Results Page. When the loader is complete, the instance's state will change to Valid.

Automatic Reloads

You also have the option to automatically reload each instance's data daily.

Continue reading below for more information.

Modify an Instance's Properties (Including Automatic Reloads)

To modify an instance's properties (names, comments, keywords, automatic reload), follow these steps:

  1. Select the definition associated with the instance you wish to modify using the Definition drop-down menu.
  2. Click the Edit icon () that corresponds with the instance you wish to modify.
  3. Modify your instance's properties, as required.
  4. Click image to expand or minimize.

  5. To enable auto reloading, enable the Auto reload data? checkbox, and select a time using the Daily at field.
  6. When you've finished modifying your instance, click the Save button.
  7. Changing an instance's name will change both of it's URLs. If you change an instance's name, you will be prompted to confirm the change.
  8. If necessary, confirm the name change by clicking the OK button.
  9. Click image to expand or minimize.

Delete a Result Set Instance

To delete an instance, follow these steps:

  1. Select the definition associated with the instance you wish to delete using the Definition drop-down menu.
  2. Click the Delete icon () that corresponds with the instance you wish to delete.
  3. You will be prompted to confirm the deletion. Click the OK button to delete your instance.

Copy a Feed URL to the Clipboard

You can copy feed URLs to the clipboard using the Copy icons () in the oData URL column of the table.

Hover your cursor over a copy icon to view the URL associated with it.

Lock/Unlock a Result Set

When you lock a result set:

  • You won't be able to reload its data.
  • You won't be able to delete it.
  • You won't be able to modify its properties.

To lock a result set, follow these steps:

  1. Select the definition associated with the instance you wish to lock using the Definition drop-down menu.
  2. Click the Lock icon () that corresponds with the instance you wish to lock.
  3. You will be prompted to confirm the lock. Click OK to lock the instance.

Add or Remove Columns from the Table

You can hide or display any of the columns on the Result Set Instances table. To add or remove a column from the table, follow these steps:

  1. Click the Filtering Options icon ().
  2. Click image to expand or minimize.

  3. Click on the column you wish to add or remove from the table.
    1. Add columns: Columns with an "X" beside them () are not displayed in the table — clicking columns with an "X" beside them will add them to the table.
    2. Remove columns: Columns with a checkmark beside them () are already in the table — clicking columns with a checkmark beside them will remove them from the table.
  4. Descriptions of each column type can be found in the table below.
  5. When you have finished selecting the columns you wish to display, click on the table to close the menu.
FilterDescription
NameThe name of each result set.
State

The state of the result set. One of three states will be displayed: 

  1. Initializing
  2. Valid
  3. Invalid
VersionThe version the result set's data is linked to.
Created

The date and time when the instance was created.

Last UpdatedThe last date and time when the instance's data was updated.
Schedule TimeIf you enable automatic reloads for an instance, the scheduled time for the reload will be listed in this column.
oData URLButtons to copy each instance's navigation and/or table OData feed URLs are included in this column.
CommentsThe comments associated with each instance.
KeywordsThe keywords assigned to each instance.

Filter Values in Columns of the Result Set Instances Table

Clicking on a column title will allow you to sort the values in the column by alphabetical, numeric, or timed order (depending on the values in the column). You can apply more than one filter at a time by holding the SHIFT key on your keyboard while selecting columns. When you sort multiple columns, numbered icons will be added to the column title to indicate the order in which they are sorted. In the example below, the Run State column was sorted before the Execution Time column.

Some columns also include search fields. Use these to search for values in the table.

Third-Party Reporting

Once you've created an instance of a reporting result set, you can pass your data to Excel and Spotfire using the instance's feed URLs. For more information, see: